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The attached document is a draft section of Pilot: The OIS Control Program Functional 
Specification describing the facilities which support the lUTFP. The software interface which 
supports the UTVFC will almost be identical. 

I would much appreciate receiving your comments before incorporating this section into the 
fimctional specification. Your comments can have a large impact; 1 circulate this draft more for 
purposes of discussion hoping to reach a final consensus on the form of the display interface. 7Tie 
salient points of this design include no hardware assist for implementing a cusor, low level support 
for a very primitive display controller, and no software for encoding keyboard data into a scries of 
key strokes. 
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Louros, W. Lynch, T. Malloy, R. Metcalfe, L. Padgett, G. Shaw, C. Thacker, T. Townsend 
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This document can be found on [Iris] < Jarvis > iutfp-specs.bravo 

1.1 Client Control of the lUTFP 

The Interim User Terminal Full Page, lUTFP consists of a mouse, a keyboard, and a high resolution 
video display. Tlie display is refreshed from a bit map in main storage. The 128 key keyboard and 
5 the three mouse buttons are unencpded; the controller maintains their state as a bit array in main 
storage along with two words for the x and y mouse coordinates. 

LLI Creation of a lUTFP Channel 

To create an lUTFP channel the client calls 

lUTFP. Create: procedure[] RETURNS[iUTFP.ChannelHand!e]; 

10 To delete the lUTFP channel, the client calls 

lUTFP. Delete: PROCEDURE[iUTFP.ChannelHandle]; 

lUTFP.ChannelHandle: type = private . . . ; 

Subsequent calls to the procedures described below allow the client to manipulate the display, 
keyboard, and mouse. 

15 1,1.2 Display 

Tlie controller scans the display line by line from top to bottom starting with line zero. The client 
can partition the display into a series of horizontal stripes mapping a block of storage into a stripe 
with a record of the form 

lUTFP.PhysicalRecord: type = record [ 
20 background: {black, white}, 

y: CARDINAL, 

leftMargin: cardinal, 
pixelsPerLine: cardinal, 
lines: cardinal, 
25 buffer: LONG pointer]; 

lUTFP.PhysicalRecordHandle: pointer to lUTFP.PhysicalRecord; 

Tlie client sets the background to either black or white with background field. Tlie background at 
the bottom of the display matches the background of the last stripe in the display list. 

Tlie y field specifies the location of the stripe relative to the other stripes in tlic display list. Tlie 

30 value of y docs not fix the absolute location of the stripe on the display, instead, this value serves as 

a hint to the channel about where to insert the stripe in the display list. Tliis scheme makes 
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overlapping stripes impossible; fiirtheiTnore, if the client attempts to insert two PhysicalRecords 
with the same y, he cannot predict which stripe will appear first in the display list. 

The left Margin contains a count of the number of pixels to skip before displaying data from the 
buffer on the scan line, lliis number should be evenly divisible by 16, if not. the low four bits are 
5 ignored. 

The pixelsPerLine field holds the number of pixels on a line which come from the scan line 
buffer. The other pixels on the line arc displayed as background. This number should be evenly 
divisible by 64; the low six bits of this word are ignored. If the client wishes to display only 
background in the stripe, he should set this field to zero. 

LO The number of lines scanned in the stripe comes from the lines field. 

Finally, buffer points to the scan line buffer of (pixclsPerLine*lines)/16 words. Tlie controller 
scans each line from left to right as it reads from the buffer word by word from low addresses to 
higlier ones. The high order bits of a word are displayed to the left of the low order bits. A zero 
represents a pixel which matches the background, while a one represents a bit which complements 
L5 the background. 

Note: ITie controller does not support a cursor. The client can simulate the effect of a cursor by 
modifying the bit map from which die controller refreshes the display. 

llie client inserts* a stripe into the display list by calling 

lUTFP.Put: PROCEDURE[channel: lUTFP.ChannelHandle, rec: 
20 lUTFp.PhysicalRecordHandle] RETURNs[iUTFP.CompletionHandle]; 

The stripe is inserted into the display list before tlie procedure returns. Inserting a stripe into the 
middle of a display list scrolls down any stripes below. 

llie client can modify any or all of an existing stripe's parameters by calling 

lUTFP.ModifyStripe: PROCEDURE[channel: lUTFP.ChannelHandle, rec: 
25 lUTFP.PhysicaiRecordHandie, stripe: lUTFP.ComplelionHandle] 

RETURNS[error: boolean]; 

If the client passes a CompletionHandle that does not match a stripe in the display list, the 
procedure returns tme. If the location of the stripe relative to other stripes in the display list 
changes, the specified stripe moves on the display. 

30 A stripe is removed from the display list by calling 

lUTFP. Remove: PROCEDURE[channel: lUTFP.ChannelHandle, stripe: 
lUTFP.ComplelionHandle]; 

The stripe is removed from tlie display before the procedure returns. Any stripes below the one 
removed are scrolled up. 

35 The lUTFP controller supports more than one display configuration. To obtain information about 
the attached display die client calls: 
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lUTFP. Display Parameters: PROCEDURE[channel: lUTFP.ChannelHandle] 
RETURNS[XPixels: CARDINAL, YPixels: CARDINAL, XLength: cardinal, 
YLenglh: cardinal]; 

The mimber of scan lines and pixels on a scan line are given by YPixels and X Pixels respectively. 
5 llie dimensions, in millimeters, of the displayed area are given by XLength and YLenglh. 

1.1.3 Keyboard and Mouse 

The controller maintains the state of mouse and keyboard in the Key Record. 

lUTFP.KeyRecord: type = machine dependent record [ 
x-(2*w:w)-: cardinal, 
10 y-{3*w:w)-: cardinal, 

keys-(4*w: 8*w)--: array [0..7] of unspecified]; 

The pixel coordinates of the mouse are given by x and y. The mouse axes correspond exactly with 
the display axes. 

Each of the 128 bits of keys corresponds to a keyboard key or a mouse button. If tlie bit is a one 
15 the correspoinding key is depressed. 

Note: At present, the mapping between the keys on the keyboard and its corresponding location 
in the bit array is unknown. 

The client discovers the location of the Key Record by calling 

lUTFP.LocateKeyRecord: PROCEDURE[channel: lUTFP.ChannelHandle] 
20 returns[long pointer to KeyRecord]; 

A process which wants to wait for a key stroke can call 

iUTFP.WaltForKeystroke[channel: lUTFP.ChannelHandle]; 

This procedure does not return until a key is released, depressed, or tlie mouse location changes. 

1.1.4 Programming the Controller 

25 [This section really belongs in the design specification. I include it to keep information from 
fragmenting^ 

The format of the lUTFP controller status block is 

lUTFP.CSB: TYPE = MACHINE DEPENDENT RECORD [ 

chain-{0:w)": lUTFP.IOCBIndex, 
30 pad48-{w:3'*'w)-: unspecified, 

pad8-{0:8)-: [0..377B], 
change-{8:24)--: long pointer to condition, 
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keys--(4*w, 12*w)--: lUTFP.KeyRecord]; 

The format for the lUTFP input/output control block is given by 

lUTFP.IOCB: TYPE = MACHINE DEPENDENT RECORD [ 

next--(0:w)-: lUTFP.IOCBIndex, -- quad word aligned 
5 bow--{2*w:1)-: boolean, -- black on white bit 

pad9-{2*w + 1:9): [0..777B], 
left-(2*w + 10:6)-: [0..77B], - in words 
lineSi2e-(3*w:w)--: cardinal, -- in words 
pad8-(0:a)-.: [0..377B], 
LO buffer-(8:24)--: LONG pointer to unspecified]; 
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